home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / comm / net / MiamiDxWebCP.readme < prev   
Encoding:
Text File  |  2000-09-02  |  6.3 KB  |  180 lines
  1. Short:    MiamiDxWebCP 2.3 - a Web Control Panel for MiamiDx
  2. Author:   Martin Steigerwald <Martin-Steigerwald@gmx.net>
  3. Uploader: Martin Steigerwald <Martin-Steigerwald@gmx.net>
  4. Type:     comm/net
  5.  
  6.  
  7.  
  8. $VER: MiamiDxWebCP.readme 2.3 (3.7.2000) (W) by Martin Steigerwald
  9.  
  10. MiamiDx Web Control Panel 2.3 (3.7.2000) (W) by Martin Steigerwald
  11.  
  12.  
  13.  
  14. What is it?
  15. -----------
  16.  
  17. MiamiDx Web Control Panel implements some of the functionality of the
  18. original Control Panel for MiamiDx via ARexx cgi-bin scripts (see
  19. "Example.html" or german language user "Beispiel.html"). So if you have a
  20. local network with your Amiga as internet router, anyone at one of the
  21. other machines of your local network can tell MiamiDx on your Amiga to go
  22. online or offline. Also you self can use the Web Control Panel.
  23.  
  24. Why not dial on demand? Well easy. In germany most internet providers give
  25. dynamic IP addresses and also charge costs by time. This makes it dificult
  26. to configure dial on demand in a satisfying way. If the time it stays
  27. online without traffic is to short, you might loose your ICQ connections
  28. and stuff, cause on next connect the IP is changed. If it is too long, you
  29. loose money. And then there are applications that think they should query
  30. the internet from time to time without user interaction to check for
  31. updates or whatever. With a Web Control Panel the local users actually
  32. have *full* control when your Amiga goes online.
  33.  
  34.  
  35. Requires
  36. --------
  37.  
  38. MiamiDx 1.0c with properly set up IP Nat routing (well otherwise it would
  39. not make much sense):
  40.  
  41. http://www.nordicglobal.com
  42.  
  43. A web server with working ARexx gateway.
  44.  
  45. I recommend Apache 1.3.12 or later:
  46.  
  47. http://amiga-apache.home.pages.de
  48.  
  49.  
  50. Installation
  51. ------------
  52.  
  53. Install the webserver and configure it properly so that arexx cgi scripts
  54. will work. In »Apache:conf/httpd.conf« search the line »AddHandler
  55. cgi-script .cgi«. Add a the following line after it:
  56.  
  57. AddHandler cgi-script .rexx
  58.  
  59. Usually cgi-scripts are either located in your cgi-bin directory or have
  60. to have one of the extensions given by those »AddHandler cgi-script«
  61. directives.
  62.  
  63. Add a proper directory entry to »httpd.conf«, like this:
  64.  
  65. Alias "/MiamiDxWebCP" "/Miami/MiamiDxWebCP"
  66. <Directory "/Miami/MiamiDxWebCP">
  67.     Options Indexes FollowSymLinks MultiViews ExecCGI
  68.     AllowOverride Limit
  69.     Order allow,deny
  70.     Allow from 127.0.0.1 192.168.1
  71. </Directory>
  72.  
  73. It is important to only allow your local users access to this directory!
  74. Especially if you want people from the net have access to other
  75. directories of your local web server. If you do not want this, you can
  76. raise up automatic firewall from MiamiDx under »TCP/IP«, »LAN-Connect« to
  77. be completely sure.
  78.  
  79. Dearchive the script into »Miami:MiamiDxWebCP« and adapt it to your needs.
  80. Just place your favorite ppp interfaces you want to make accessible or at
  81. last queryable into the list in "MiamiDxWebCP.rexx" and set how many you
  82. have. For each interface you can define whether:
  83.  
  84. interface.1="ppp0"              - This is the MiamiDx interface name
  85. interface.1.name="Freenet"      - This is the name shown to the user
  86.                                   of MiamiDxWebCP
  87. interface.1.access="yes"        - Controls whether a MiamiDxWebCP user may
  88.                                   switch the interface on- or offline remotely.
  89. interface.1.description= "..."  - Some description also shown to the user.
  90.                                   Could for example contain an info on how
  91.                                   much the internet costs using this
  92.                                   interface are.
  93.  
  94. You may also want to adapt BeginHTML() and EndHTML() and the interfaces
  95. table generation code to your taste.
  96.  
  97. Have fun. You can now test the MiamiDx Web Control Panel by pointing your
  98. browser to the following URL:
  99.  
  100. http://localhost/MiamiDxWebCP/MiamiDxWebCP.rexx
  101.  
  102. German users may want to use:
  103.  
  104. http://localhost/MiamiDxWebCP/MiamiDxWebCP.rexx?lang=de
  105.  
  106.  
  107. Security
  108. --------
  109.  
  110. The directory directive shown above makes sure that only users on local
  111. computers may access MiamiDxWebCP. The ".htaccess" file in the
  112. MiamiDxWebCP directory may act as a safeguard when you configured the
  113. MiamiDxWebCP directory incorrectly in »httpd.conf«. If your computers are
  114. on another network than "192.168.1" with netmask "255.255.255.0" you have
  115. to adapt this file.
  116.  
  117. Another easy and very safe way to make sure that MiamiDxWebCP is not
  118. accessed from outside your local network is to enable the MiamiDx
  119. automatic firewall setup and make sure that there is no http in the
  120. exception list. But then all your local pages are blocked.
  121.  
  122.  
  123. Future
  124. ------
  125.  
  126. I will only add features when I need and/or have fun while adding features
  127. that other users of MiamiDxWebCP suggest.
  128.  
  129.  
  130. History
  131. -------
  132.  
  133. revision 2.3
  134. date: 2000/07/03 13:03:57;  author: helios;  state: Exp;  lines: +12 -12
  135. - changed my internet provider settings
  136.  
  137. revision 2.2
  138. date: 2000/06/05 20:11:25;  author: helios;  state: Exp;  lines: +47 -27
  139. - put in design from Leo
  140. - admin.name and admin.email configurable at beginning of the script
  141. - uses font face "Arial, Helvetica"
  142. - also outputs version info on the webpage
  143.  
  144. revision 2.1
  145. date: 2000/06/01 18:11:48;  author: helios;  state: Exp;
  146. - made 10 scripts into one script by using CGI argument parsing
  147. - two-language support: english and german
  148. - changed variable names a bit
  149.  
  150.  
  151. Thanks
  152. ------
  153.  
  154. Holger Kruse for MiamiDx.
  155.  
  156. The developers of Apache and the makers of its Amiga port.
  157.  
  158.  
  159. Martin 'Helios' Steigerwald - mailto:Martin-Steigerwald@gmx.net
  160. http://helios.home.pages.de
  161.  
  162.  
  163. ============================= Archive contents =============================
  164.  
  165. Original  Packed Ratio    Date     Time    Name
  166. -------- ------- ----- --------- --------  -------------
  167.     1694    1365 19.4% 02-Jun-00 14:59:34  MiamiDxWebCP.info
  168.       45      45  0.0% 05-Jun-00 22:14:06 +.htaccess
  169.     2418     741 69.3% 03-Jul-00 14:07:24 +Beispiel.html
  170.     2488    2117 14.9% 03-Jul-00 14:09:12 +Beispiel.html.info
  171.     2418     742 69.3% 03-Jul-00 14:07:52 +Example.html
  172.     2488    2117 14.9% 03-Jul-00 14:09:00 +Example.html.info
  173.     5506    2404 56.3% 03-Jul-00 14:27:34 +MiamiDxWebCP.readme
  174.     1696    1286 24.1% 19-Apr-00 22:22:16 +MiamiDxWebCP.readme.info
  175.     6761    2354 65.1% 03-Jul-00 14:10:04 +MiamiDxWebCP.rexx
  176.     2326    2326  0.0% 03-Jul-96 06:18:14 +apache_pb.gif
  177.     2029    1972  2.8% 25-May-00 12:22:34 +BuiltWithAmiga.png
  178. -------- ------- ----- --------- --------
  179.    29869   17469 41.5% 05-Jul-100 00:41:40   11 files
  180.